home *** CD-ROM | disk | FTP | other *** search
/ AmigActive 21 / AACD 21.iso / AACD / Utilities / Help / locale / help / english / sys / iconx.doc < prev    next >
Encoding:
Text File  |  2000-10-06  |  2.4 KB  |  65 lines

  1. ICONX
  2.  
  3. Note:
  4.  
  5. ICONX is used only as a default tool in a project icon and cannot be used as
  6. a Shell command.
  7.  
  8. Allows execution of a script file of AmigaDOS commands from an icon.
  9.  
  10. Format
  11.  
  12. ICONX
  13.  
  14. Template
  15.  
  16. (none)
  17.  
  18. Location
  19.  
  20. C:
  21.  
  22. To use ICONX, create or copy a project icon for the script. Open the icon's
  23. Information window and change the Default Tool of the icon to C:ICONX and
  24. select Save to store the changed .info file. The script can then be executed
  25. by double-clicking on the icon.
  26.  
  27. When the icon is opened, ICONX changes the current directory to the directory
  28. containing the project icon before executing the script. A console window can
  29. be opened on the Workbench screen if the script produces output.
  30.  
  31. Several Tool Types can be specified in the script icon. The WINDOW Tool Type
  32. provides an alternate window specification for the input/output window. By
  33. default, the window's specification is:
  34.  
  35. WINDOW=CON:0/50//80/IconX/AUTO/WAIT/CLOSE
  36.  
  37. The AUTO option opens a window only if there is output created by the script.
  38. If a window opens, the WAIT option forces it to remain open after the script
  39. terminates until you specifically close it. The CLOSE option gives the window
  40. a close gadget.
  41.  
  42. The WAIT Tool Type (not to be confused with the WAIT option of the WINDOW
  43. Tool Type) specifies the number of seconds the input/output window should
  44. remain open after the script terminates. If you use this option the default
  45. input/output window cannot be closed before the WAIT period has expired.
  46. There is also a DELAY Tool Type that works in very similar way, except that
  47. its parameter is in 1/50th of a second, instead of in seconds.
  48.  
  49. The STACK Tool Type specifies the number of bytes to use for stack during
  50. script execution. If this Tool Type is not provided, the default 4096 bytes
  51. is used.
  52.  
  53. Finally, the USERSHELL Tool Type runs the script file using the current Use
  54. Shell instead of the normal ROM Shell. You must specify USERSHELL=YES. User
  55. Shells are third party shells that you can purchase and install in your
  56. system to replace the standard Amiga Shell environment that comes with the
  57. operating system.
  58.  
  59. Extended selection passes files that have icons to the script. Their file
  60. names appear to the script as keywords. To use this facility, the .KEY
  61. keyword must appear at the start of the script. In this case, the AmigaDOS
  62. EXECUTE command is used to execute the script file.
  63.  
  64. See also: EXECUTE. For examples using the ICONX command, see Chapter 8.
  65.